package com.zenithmind.library.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.zenithmind.library.pojo.domain.Category;
import com.zenithmind.library.pojo.query.CategoryQuery;
import com.zenithmind.library.pojo.vo.CategoryVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 图书分类Mapper接口
 * 
 * @author ZenithMind
 * @since 2024-06-14
 */
@Mapper
public interface CategoryMapper extends BaseMapper<Category> {

    /**
     * 分页查询分类
     * 
     * @param page 分页参数
     * @param query 查询条件
     * @return 分页结果
     */
    IPage<CategoryVO> selectCategoryPage(Page<CategoryVO> page, @Param("query") CategoryQuery query);

    /**
     * 查询分类树
     * 
     * @param parentId 父分类ID
     * @return 分类树
     */
    List<CategoryVO> selectCategoryTree(@Param("parentId") String parentId);

    /**
     * 查询所有分类树
     * 
     * @return 分类树
     */
    List<CategoryVO> selectAllCategoryTree();

    /**
     * 根据编码查询分类
     * 
     * @param code 分类编码
     * @return 分类信息
     */
    CategoryVO selectByCode(@Param("code") String code);

    /**
     * 查询子分类
     * 
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<CategoryVO> selectChildren(@Param("parentId") String parentId);

    /**
     * 统计子分类数量
     * 
     * @param parentId 父分类ID
     * @return 子分类数量
     */
    int countChildren(@Param("parentId") String parentId);

    /**
     * 更新分类层级信息
     * 
     * @param id 分类ID
     * @param level 层级
     * @param path 路径
     * @param isLeaf 是否叶子节点
     * @return 更新行数
     */
    int updateCategoryLevel(@Param("id") String id, 
                           @Param("level") Integer level, 
                           @Param("path") String path, 
                           @Param("isLeaf") Integer isLeaf);

    /**
     * 批量更新分类状态
     * 
     * @param ids 分类ID列表
     * @param status 状态
     * @return 更新行数
     */
    int batchUpdateStatus(@Param("ids") List<String> ids, @Param("status") Integer status);

    /**
     * 更新图书数量
     * 
     * @param categoryId 分类ID
     * @param bookCount 图书数量
     * @return 更新行数
     */
    int updateBookCount(@Param("categoryId") String categoryId, @Param("bookCount") Long bookCount);

    /**
     * 查询热门分类
     * 
     * @param limit 限制数量
     * @return 热门分类列表
     */
    List<CategoryVO> selectHotCategories(@Param("limit") Integer limit);

    /**
     * 检查分类编码是否存在
     * 
     * @param code 分类编码
     * @param excludeId 排除的ID
     * @return 是否存在
     */
    boolean existsByCode(@Param("code") String code, @Param("excludeId") String excludeId);

    /**
     * 检查分类名称是否存在
     * 
     * @param name 分类名称
     * @param parentId 父分类ID
     * @param excludeId 排除的ID
     * @return 是否存在
     */
    boolean existsByName(@Param("name") String name, 
                        @Param("parentId") String parentId, 
                        @Param("excludeId") String excludeId);
}
